home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / fri_201.arc / FRIDAY.DOC < prev    next >
Text File  |  1991-09-19  |  20KB  |  413 lines
  1.  
  2.           ╒════════════════════════════════════════════════════════╕
  3.           │  Friday 2.01 - the quest for automation continues ...  │
  4.           └────────────────────────────────────────────────────────┘
  5.  
  6.  Friday.Exe/Friday.Doc written by geoffrey booher; 1:2270/233.0@fidonet.usa
  7.  
  8. ┌─────────────┐
  9. │ disclaimer: │
  10. └─────────────┘
  11.  Friday 2.01 is  *ONLY*  guaranteed to consume diskspace.  It has been very
  12.  extensively  tested and  found  to be pretty  reliable.   In no way is the
  13.  author  of this  program responsible  for any  damages, consequential,  or
  14.  otherwise from the neglect of Friday 2.01's use or misuse.  Friday 2.01 is
  15.  provided as is, without warranty of any kind, either expressed or implied.
  16.  
  17.  Friday 2.01 is  NOT  Public Domain Software, it's just basically free.  It
  18.  may be freely used on any Computer with the following restrictions:
  19.  
  20.  1.  Any part of the Friday 2.01 files are NOT to be modified in *any* way.
  21.  
  22.  2.  The Friday Distribution Archive is NOT to be recompressed/reprocessed.
  23.  
  24.  3.  Friday 2.01 may NOT be utilized in any unlawful or illegal manner.
  25.  
  26.  4.  No Fees may be charged for Friday 2.01 - other than diskette cost.
  27.      FRI_201.ZIP may be put up for download on pay/subscription systems,
  28.      provided a fee is not charged for downloading FRI_201.ZIP itself.
  29.  
  30. ┌──────────┐
  31. │ support: │
  32. └──────────┘
  33.  Send Netmail to Geoffrey Booher, 1:2270/233.0@fidonet.  If you are expecting
  34.  a response, usually if you return poll me within 24 hours (nay weekends) and
  35.  I'll respond with a Netmail msg on HOLD for you.   This assumes you are in a
  36.  current *FIDONET* Nodelist.
  37.  
  38.  Geoffrey Booher - SysOp - The Gateway Net Bulletin Board System
  39.                            North American RemoteAccess Support
  40.                            RemoteAccess Beta Site
  41.                            AVA Support/Registrations
  42.                            1:2270/233.0@fidonet.usa
  43.                            (815)233-5008  1200/2400/9600/14400  HST/V32b/V42b
  44.                            Freeport, IL - USA
  45.  
  46.  You can contact me through the above Bulletin Board System.  Feel free to
  47.  send me your comments about Friday 2.01.  I have received MANY to date.
  48.  
  49.  If you aren't a BBS SysOp, you probably won't have a use for this program.
  50.  
  51.  :-)
  52.  
  53. ┌────────────────────────┐
  54. │ overview and features: │
  55. └────────────────────────┘
  56.  I *always* wanted a program to change my  FILES.BBS  on Fridays when  I get
  57.  the  new  Nodediff and make the new  Nodelist.  I used to go in and have to
  58.  change  NODEDIFF.A56  NODELIST.A56  to  NODEDIFF.A63  and  NODELIST.A63 for
  59.  example in my  FILES.BBS with a text editor on Fridays.  (not what you call
  60.  automation).  I noticed that some  BBS Software will work with NODEDIFF.A??
  61.  (wildcards)  in the  FILES.BBS,  but ONLY  when listing the  files,  NOT on
  62.  searches by filename or keyword, or New files since last call.
  63.  
  64.  Friday 2.01  automates the process by searching the  subdirectory specified
  65.  for the NODEDIFF.A?? NODELIST.A?? and updates FILES.BBS with the new names.
  66.  
  67.  /Option Switches        (/H or /? displays a help screen only)
  68.  
  69.  /A       NODE????.A?? - ARC (default - no /option parameter entered)
  70.  /D       NODE????.D?? - DWC
  71.  /J       NODE????.J?? - ARJ
  72.  /L       NODE????.L?? - LZH
  73.  /N       NODE????.nnn - unarchived - julian date extension
  74.  /P       NODE????.P?? - PAK
  75.  /Z       NODE????.Z?? - ZIP/ZOO
  76.  /On      use n days (0-6) offset from Friday
  77.  /F       FNEWS???.*  (FidoNews option)
  78.  /Faname  ANAME???.*  (Any List name!)
  79.  
  80.  Friday will also search for ANYLIST, any valid filename that uses the above
  81.  filename extension  conventions, which most networks do.   If your net does
  82.  not, I  don't know about it!   By making the  filename(s) available  on the
  83.  commandline, I have  eliminated the  need for any  .CTL files and a need to
  84.  know every netdiff/list.  I think the methodology used is pretty effective.
  85.  
  86.  Friday 2.01  replaces the last two  digits of the  filename(s) descriptions
  87.  with the  two  rightmost digits of the  Julian date of  the past  Friday as
  88.  obtained from DOS and calculated. I guess I should mention that if the time
  89.  and date on your computer are improperly set, expect unpredictable results!
  90.  
  91.  This program started out simple. Typing FRIDAY just looked for NODEDIFF.A??
  92.  and  NODELIST.A?? in the current directory only, and  NEEDED to be executed
  93.  on  Fridays.  It  has now evolved  to many  commandline  switches, and  now
  94.  automagically  calculates and  uses the current/past Nodediff day.  It also
  95.  accepts a pathname to the FILES.BBS - and many many more options.
  96.  
  97.  Portion of my FILES.BBS:
  98.  
  99.  -----------
  100. NODEDIFF.A56  Latest Fidonet Weekly Nodelist Update File
  101. NODELIST.A56  Latest Complete Fidonet Nodelist File
  102.  -----------
  103.  
  104.  My FILES.BBS after I received and processed the NODEDIFF.A?? file and
  105.  Friday 2.01 was run on Friday 09/20/91 up to 12am 09/27/91:
  106.  
  107.  -----------
  108. NODEDIFF.A63  Latest Fidonet Weekly Nodelist Update File
  109. NODELIST.A63  Latest Complete Fidonet Nodelist File
  110.  -----------
  111.  Note the generic descriptions - I'll never edit those lines again!  <smile>
  112.  If you aren't familiar with FILES.BBS, you might not need this program.
  113.  
  114. ┌──────────────────────────────┐
  115. │ overview and features con't: │
  116. └──────────────────────────────┘
  117.  
  118.   FILES.BBS  is a straight  ASCII text file  that  is usually  located in the
  119.  subdirectory where you keep download files.  It keeps a "list" of filenames
  120.  and descriptions.  The  filename is the 1st 12 positions  (counting the '.'
  121.  character).   Then, starting  in  position 15  is the description,  usually
  122.  40-45 characters  'describing'  the file.  The  description doesn't have to
  123.  start in  15  (it can start in 14)  -  but  lots  of other  file management
  124.  utilities like it that way.  See the sample FILES.BBS enclosed for the many
  125.  examples of what Friday 2.01 now supports.
  126.  
  127.  
  128. ┌─────────────────────────┐
  129. │ setting up Friday 2.01: │ (Nodediff/Nodelist Flavor)
  130. └─────────────────────────┘
  131.  Put  Friday.Exe anywhere in your DOS PATH, along with any of your other BBS
  132.  Program utilities.  See your DOS manual about the PATH Statement if needed.
  133.  
  134.  Just change the batchfile that updates your nodelist and add FRIDAY at the
  135.  end:
  136.  
  137.    my NODELIST.BAT:
  138.    @Echo OFF
  139.    If Not Exist C:\Fd\File\Nodediff.A?? GOTO END
  140.    Move C:\Fd\File\Nodediff.A?? C:\Fd\Nodelist
  141.    Ren C:\Ra\Bbsfiles\Node????.A?? Node????.Old
  142.    Cd C:\Fd\Nodelist
  143.    Copy C:\Fd\Nodelist\Nodediff.A?? C:\Ra\Bbsfiles
  144.    Rem - the following Xlaxdiff command makes the new NODELIST.A?? file
  145.    Xlaxdiff /A=C:\Ra\Bbsfiles\Nodelist /X=ARCE,ARC A /C
  146.    If Errorlevel 1 Goto NDERROR
  147.    Cd C:\Ra
  148.    Ranode
  149.    Cd C:\Fd
  150.    Fdnc /f
  151.    Del C:\Ra\Bbsfiles\Node????.Old
  152.    Rem - Friday 2.01 will update your FILES.BBS with the latest Nodelist files.
  153.    Rem - I'm using A??, it is the default when no parameters are entered.
  154.    Friday C:\Ra\Bbsfiles
  155.    Goto END
  156.    :NDERROR
  157.     Rem - if there was a problem applying the Nodediff - do NOTHING
  158.     Echo An error occurred while processing the Nodediff! >>C:\Fd\Fd.Log
  159.    :END
  160.  
  161.  Friday 2.01  *expects*  to find, open and search  FILES.BBS.  If it doesn't
  162.  it will beep  at you and tell  you it can not be found.  If the filename(s)
  163.  are  not found in the  specified subdirectory and if the  FILES.BBS doesn't
  164.  contain  NODEDIFF.A  or NODELIST.A  (or D,J,L,N,P,Z with  correct parameter
  165.  command) it won't do anything.  If FILES.BBS and  NODEDIFF.A and NODELIST.A
  166.  are found, it will put the last  2 rightmost digits of the current Nodediff
  167.  day into the  proper spot and update  FILES.BBS.  ARC is still the  Fidonet
  168.  NODELIST  Standard, and  is the  default (no  parameters  entered).   If no
  169.  pathname is entered, Friday looks for the  filename(s) and FILES.BBS in the
  170.  current drive/directory.  If your  BBS Software  uses another  name besides
  171.  FILES.BBS  and follows it's file format as described above, you can use the
  172.  FRIDAY environment variable to tell  Friday to search another filename.
  173.  SET FRIDAY=FILES.DIR  causes  FILES.DIR  to  be acted  upon.  You may  ONLY
  174.  specify a valid DOS Filename  (no wildcards or path specifiers).  If you do
  175.  NOT use (need) this, the DEFAULT is FILES.BBS and no SET FRIDAY= is needed.
  176.  
  177. ┌─────────────────────────┐
  178. │ setting up Friday 2.01: │ (FidoNews, Newsletter Flavor)
  179. └─────────────────────────┘
  180.  Make sure Friday.Exe is anywhere in your PATH, along with any of your other
  181.  BBS/Program utilities.  See your  DOS manual  about the  PATH Statement  if
  182.  needed.
  183.  
  184.  change the batchfile that updates your fidonews and add FRIDAY /F to it.
  185.  
  186.    my FIDONEWS.BAT:
  187.  
  188.    @Echo OFF
  189.    If Exist C:\Ra\Docos\Fnews???.* Del C:\Ra\Docos\Fnews???.*
  190.    Move C:\Fd\File\Fnews???.* C:\Ra\Docos
  191.    rem - Friday 2.01 updates your FILES.BBS with the FNEWS file you received.
  192.    rem - /F alone defaults to Fidonews, /Ffnews NOT needed.
  193.    Friday /F C:\Ra\Docos
  194.  
  195.  That's all there is to it.  When your Mailer receives the File, have in your
  196.  inbound Mail statement in your main Runbbs.Bat file:
  197.  
  198.  :MAIL
  199.   rem - Toss Incoming EchoMail and NetMail here
  200.   If Exist C:\Fd\File\Nodediff.A?? Call Nodelist.Bat
  201.   If Exist C:\Fd\File\Fnews???.* Call Fidonews.Bat
  202.   Goto START
  203.  
  204.  Friday /F  expects to find an  FNEWS???.* file in the current directory you
  205.  are running from or pointing to with the pathname. If not, it will quit and
  206.  tell you so.  If it finds the  FNEWS???.*  file in the current directory or
  207.  specified path, and cannot find a FILES.BBS also, it will quit and tell you
  208.  so.  If it finds  FNEWS???.* in the current directory or specified path and
  209.  finds a FILES.BBS, it then looks for FNEWS in the FILES.BBS. If FNEWS isn't
  210.  found in  FILES.BBS  -  it will again do nothing.  If it finds FNEWS in the
  211.  FILES.BBS,  it replaces it with the filename found in the current directory
  212.  or specified pathname (the one just moved there ideally).
  213.  
  214.  Friday  has the ability to accept a  2 to 7  character  string  immediately
  215.  following the /F parameter.  Note, there are  NO SPACES  between the /F and
  216.  the string.  This allows you to update most weekly/monthly listings with no
  217.  intervention on your part.
  218.  
  219.  Friday /Fusbbs C:\Ra\Docos  (i.e: updates USBBS86.ZIP to USBBS87.ZIP)
  220.  Friday /Fbbs C:\Ra\Docos    (i.e: updates BBS0891.ZIP to BBS0991.ZIP)
  221.  
  222.  WARNING!!  Use of LESS than 4 matching characters (as in above /Fbbs
  223.             example  of  Thelist BBS????.*) can  get you into trouble
  224.             FAST!   If there's  another file in that directory called
  225.             BBS*.*  Friday MAY go after that, and produce undesirable
  226.             results!
  227.  
  228.  
  229. ┌───────────┐
  230. │ appendix: │
  231. └───────────┘
  232.  
  233.  Friday Command Syntax:   *NOTE*  Commands  MUST  be entered in order given!
  234.  Since Friday is normally run from a batchfile, this shouldn't be a problem.
  235.  
  236.  Friday [/options] [/On] [filname1] [filname2] [d:\path]  (case is insensitive)
  237.  [filname1] [filname2] not valid with /f option switch.
  238.  [/On] offset is not used with the /F option.
  239.  
  240.  [filname1] [filname2] only 1 required, use for other than NODEDIFF NODELIST
  241.        
  242.  Friday Sample Commands (used in batchfiles):
  243.  
  244.  Friday  - looks for both NODEDIFF.A?? NODELIST.A?? in FILES.BBS in current
  245.            directory (default with no parameters entered on the commandline)
  246.  
  247.  Friday /f C:\Ra\Docos     - looks for Fnews*.* in pathname and FILES.BBS
  248.  
  249.  Note: /f and pathname ONLY are valid.  Runs Friday in strictly FNEWS mode.
  250.        Default  (Friday /f) is Fnews*.* and FILES.BBS in current directory.
  251.        Use the d:\path to point to your FNEWS*.* subdirectory.
  252.  
  253.  Friday C:\Ra\Bbsfiles  - looks for both  NODEDIFF.A?? and NODELIST.A?? in
  254.                           FILES.BBS and within C:\Ra\Bbsfiles subdirectory.
  255.                           (this is what I use)
  256.  
  257.  Friday /l Anydiff Anylist D:\Archives    - looks for both ANYDIFF.L?? and
  258.                                             ANYLIST.L?? in the D:\Archives
  259.                                             subdirectory and it's FILES.BBS.
  260.  
  261.  NOTES: Anydiff and Anylist can be any valid DOS filename.  Only 1 filename
  262.         is required, so  that those not  posting both files can use Friday.
  263.         Again, it defaults to NODEDIFF.A?? NODELIST.A??  - but any filename
  264.         combination with the .A?? .D?? .J?? .L?? .P?? .Z?? extension within
  265.         FILES.BBS is valid.
  266.  
  267.  Friday /z Signodes C:\Netlists  -looks for SIGNODES.Z?? in the C:\Netlists
  268.                                   subdirectory and in it's FILES.BBS.
  269.  
  270.  Friday /o2 Rbbslist C:\Netlists - looks for RBBSLIST.A?? in the C:\Netlists
  271.                                    subdirectory and in it's FILES.BBS.  Uses
  272.                                    Offset of 2 days from Friday (Sunday).
  273.  
  274.  Friday /n Dbnet C:\Netlists - looks for DBNET.nnn (the unarchived julian date
  275.                                extension) in C:\Netlists and in it's FILES.BBS.
  276.  
  277.  Friday will detect if the  FILES.BBS  is up-to-date and will not update the
  278.  FILES.BBS if it doesn't need to.  Friday  DOES  check for  DIFF/LIST  files
  279.  presence in the directory.  It scans the directory for the  names given (or
  280.  defaults  if none entered).   Upon success, it then  scans for  a match  in
  281.  FILES.BBS, and updates on the latest nodediff day, if not equal (less than)
  282.  the previous friday date.
  283.  
  284.  Note:  If default is used or  2 filenames are  entered on the  commandline,
  285.  Friday expects to find BOTH files.
  286.  
  287.  [d:\path]  is  any valid  DOS  subdirectory pathname.   Note, there is  NO
  288.  trailing backslash!  Do NOT enter a trailing backslash on the commandline,
  289.  you will get an invalid path error.
  290.  
  291. ┌─────────────────────────────┐
  292. │ Friday 2.01 technical info: │
  293. └─────────────────────────────┘
  294.  Friday.Exe  was compiled with  Borland International's  Turbo(C++) 1.00
  295.  using the Small Memory Module (  < 64kb heap ) and the C++ (Friday.Cpp)
  296.  option.  Friday will run in less than 128kb RAM (64kb code - 64kb data).
  297.  
  298.  Friday 2.01  exits with the following errorlevels for trapping in *.BAT
  299.  files.  Although not really needed, they are there for batchfile gurus.
  300.  
  301.   errorlevel 7 - Invalid /option switch parameter or /H help
  302.   errorlevel 6 - FILES.BBS already up-to-date, no action needed
  303.   errorlevel 5 - filename(s) argument not found in FILES.BBS
  304.   errorlevel 4 - filename(s) not found in subdirectory or pathname
  305.   errorlevel 3 - FILES.BBS not found in subdirectory or pathname
  306.   errorlevel 2 - Invalid pathname / filename argument string
  307.   errorlevel 1 - Error getting dostime or other error closing FILES.BBS
  308.   errorlevel 0 - successful completion FILES.BBS updated
  309.  
  310.  Friday 2.01 usually runs on Fridays (hence it's name).  But, realising not
  311.  every  SysOp gets the  Nodediff Update on  Fridays, it  calculates the day
  312.  of the week and figures out the last Nodediff day!  If you run on Saturday,
  313.  it subtracts  1 from the  Julian day to arrive at the desired number.  How
  314.  this  works is  if you run the program on  Friday or any day up until next
  315.  Friday, it will always replace the previous Fridays Nodediff day number.
  316.  
  317.  Using the Offset day sets the number of days  FROM the offset day.  So, if
  318.  the offset day is Sunday ( /O2 ) Friday updates it with the prior Sunday's
  319.  number.
  320.  
  321.  Friday 2.01 looks for FNEWS???.* in FILES.BBS and for the filename mask in
  322.  the current directory with the /F switch (defaults to FNEWS) parameter. If
  323.  both are not found, it will not do anything.  If it finds FNEWS*.* in both
  324.  places, it takes the filename found in the  current directory or  pathname
  325.  and replaces the name in the  FILES.BBS with it.  Friday works in the same
  326.  manner  with the  DIFF/LIST  option, checking if those files  exist in the
  327.  subdirectory, and in FILES.BBS.
  328.  
  329.  Any user definable string from  2 to 7  positions can be used after the /F
  330.  to check for and update a particular filemask.  Less than 4 - BE CAREFUL!!
  331.  
  332.  Friday 2.01 was tested on a 80286/12MHz system under DOS 4.01 and DOS 5.00.
  333.  It has also been tested on a 80386/33 and works well under DESQview.
  334.  
  335.  Friday 2.01 reads and then writes only the change, writing in place.  Since
  336.  it's so fast, in the unlikely event the power fails  (at the precise second
  337.  that it is updating) it will truncate FILES.BBS to 0 bytes. Friday has been
  338.  tested on a 320kb FILES.BBS and doesn't really care HOW large FILES.BBS is.
  339.  
  340.  Friday 2.01 will replace ALL matching strings in FILES.BBS.  So if you have
  341.  them in there  more than  once  (i.e: keep old NodeDiffs/Nodelists/FidoNews
  342.  hanging around) ...  then this  program is most  likely not  for you.  This
  343.  will also get you into trouble using Friday /Fxx as the 2 character minimum
  344.  can occur in a Filename and in FILES.BBS quite often (so I've found out!).
  345.  
  346.  Also, some SysOps don't keep the Nodelist/Nodediff/Fidonews files online.
  347.  Again, this program is likely not for you.
  348.  
  349. ┌─────────┐
  350. │ thanks: │
  351. └─────────┘
  352.  Thanks to  Eric Winter who helped me initially write  Friday 0.01.  Without
  353.  his help, I wouldn't have started learning the C language 2 years ago.  :-)
  354.  
  355.  Thanks  to  Kevin Zimmerman,  SysOp of  The Boomtown BBS  in  McConnell, IL
  356.  1:2270/868@fidonet for relentlessly allowing me to bash the program, change
  357.  the date on his  system hundreds of times, and  beat his hard disk to death
  358.  with one compile after another.  It was he who originally suggested the new
  359.  offset for his RBBSLIST since he joined and has now quit that network.
  360.  
  361.  Thanks  also  to  Bruce Bodger,  SysOp of  The Truckstop BBS  in  Tulsa, OK
  362.  1:170/400@fidonet for finding a few bugs, and for suggesting some excellent
  363.  enhancements to  Friday 0.01 and 0.10.  The latest version of FRIDAY can be
  364.  found on his system as well.
  365.  
  366.  Thanks to  Bob Glasser, SysOp of  Utopia Technologies Ltd in  Levittown, NY
  367.  1:107/203@fidonet  for  the  excellent suggestions  which  were  added into
  368.  Friday 2.00, the  /N unarchived option,  and the support  for other  weekly
  369.  ragnames.  Also, he provided some insight for FIXING that year rollover bug
  370.  that was evading me for months!
  371.  
  372. ┌───────┐
  373. │ misc: │
  374. └───────┘
  375.  I realize some of you use  NODEDIFF.ARC or  NODELIST.ARC in the  FILES.BBS.
  376.  IMHO,  I feel  the number  description is a little bit  better to  have  in
  377.  there.  This way, if I'm a  Fidonet SysOp that  grunged my nodelist <oops>,
  378.  I'm sure about getting the latest  version  instead of an  ARC or  ZIP  and
  379.  trusting the system I'm obtaining it from to have current Nodediff/Nodelist
  380.  files.  It is also in a  Standard name, ready to process by Nodelist update
  381.  utilities.  And you don't have to keep extra generic nodelist files hanging
  382.  around to quote-unquote "automate" things and waste valuable diskspace!
  383.  
  384.  My hope is that you will *enjoy* my program and it helps you out. One thing
  385.  is for sure, us Friday user dudes love the program!
  386.  
  387.  The following products/examples are the Copyrighted materials of their
  388.  respective named holders:
  389.  
  390.  Turbo(C++) 1.00            Borland International
  391.  DESQview                   QuarterDeck Office Systems
  392.  
  393.  Friday 2.01                Geoffrey Booher - odie software technology
  394.  
  395.  ARC                        System Enhancement Associates
  396.  DWC                        Dean W. Cooper
  397.  LZH                        Haruyasu Yoshizaki
  398.  ARJ                        Robert K. Jung
  399.  PAK                        NoGate Consulting
  400.  ZIP                        Phil Katz - PKWARE
  401.  ZOO                        Rahul Dhesi
  402.  
  403.  FrontDoor (Fd - Fdnc)      Joaquim H. Homrighausen - Advanced Engineering sarl
  404.  RemoteAccess (Ra - Ranode) Andrew Milner - Continental Software
  405.  Xlaxdiff                   Scott Samet
  406.  
  407.  Fidonet                    Tom Jennings
  408.  
  409.  DOS                        International Business Machines and Microsoft
  410.  PC/AT                      International Business Machines
  411.  
  412.  
  413.